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The Candy/Colleen I/O Subsystem is described in a series of 

manuals (cr ’books") all contained in a single cover. The manual 
hierarchy is shown below. 
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KEYBOARD/PisPLAY OPERATION MANTTAT. 


1. Introduction 

2. Screen Characters 

3. Keyboard Characters 
k. Screen Editing 





2. SCREEN CHARACTERISTICS 


The screen can be operated in any of 23 configurations (II 
aodes, with or without split screen, plus the system device, 
~de 0). These configurations can be categorized as being all 
graphics, all text, or split screen, for the purpose of our 


discussion. 


GRAPHICS MODES 


of twelve modes aro 9T » ar ,t, • , 

s are graphics modes, vich character- 

istics as shown in Booh III, page 18 . Dependiag upon ch@ ^ 
a 2-16 color selection is available for each pixel. Both left 

and right margins are movable, but the margins are meaningless 

in any mode but Mode 0. 

* 

Th« cursor is invisible in .U aod.s buc Mode 0 and i, „„ 

logical Car. acruccura bncv.an cha ancir. scraan and cha pixel- 
Chat is to say, no logical lines or records. 

NOTE: The changes made to numbers of modes reflect GTIA additions 
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TEXT MODES 


^ lre * of Che twelve modes are teirr • . 

are Caxt tnode3 > w ich characteristics as 

shown in Book III, page 13 . Xhe L f 

tert and nghc margins are movable 

(under program control, but not as a i. • , 

, uc not as a built-m keyboard function). 

Margins have no effect in any but Mode 0. 

The cursor is visible as she inverted video representation of she 

characcer on union ic r.aid.a; ic doe, nor blink. Th. Carr sora.n 

is divided inco logical element, c.Uad logical lin.,, each logical 

Una bain* oo.prisad of ona Co chraa physical Una, (of daca, noc 

rasc.r Unas). Iha number of physical lines us.d Co comprise a 

logical Una is always cha minimum repaired Co hold ch. daca for 

Chat lin.; logical Unas on ch. screen n.ed noc all have ch. sam. 
length. 


MOTE; This is only valid for hod. 0. Mode, 1 and 2, alchough ch.y 

?rmc characters on cha screen, act like graphics mod., and should 
be Created as such. 


If a user types more than three physical 
hit3 "CR," only the first three physical 
lowed by EOL). The remaining data define 


lines on the screen and 
lines are returned (fol- 
a new logical line. 


When in Mode 0, and using the Screen Editor, there are many screen 
editing functions supported, as described in Section 3. 
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Actions which nay change the number of physical lines comprising 
a logical line are: 


1. Entering data when the cursor is at the right screen 
margin. 

2. Inserting characters such that non-blank data is pushed 
pas^t the right screen nargin. 

3. Deleting characters until an entirely blank physical line 
is produced. 

U. Insert line, vhere the last logical line is pushed off 
the bottom of the screen. 








I. -put .««, configuration., th. bott™ of c „. ^ ^ ^ 

..tv«4 for four Una, of „« (40 chat.ct.ro pat U a., a, in 

*“* 0) ' "«“» is by th. scre.n editor 

(E.) and th. graphic. region io cootroUed by tha display 
device (S:). 


Two cursors are maintained in this mode of 

screen portions follow the rules described 
Modes and Text Modes. 


operation, and the two 
earlier for Graphics 



» 
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3* keyboard Chare.c+ s +•; 


sties 


Tte ^'ooard is physically i*-.h 

* ' J d 0UT as show ^ on the following 

Page. Each keystroke causes a data byte - c v- 

w ° aade available 

to the system (vhich it may i^-. no 

7 ‘ f no Program wants the data) 

Holding a key down for lonw@?» 

- age. -ban one second will cause the 

corresponding key code to be made avail 

= naae available approximately 10 

times per second until the key is released. 


? ” dUC9 ^ «<* for the SHIFT key and 

*" — •» uaad in conjunction 

Ci,n on. of tt. con. producing k.ya, and act an maa. m . 

in th. paragraphs that follov CTSL^e. vili indicate that c.p 

x is pressed vhile holding - m , 

down the CTRL key and SHIFT-* 

vill indicate a similar seau*nr*« ~ - 

sequence out using the SHIFT key. 

Sequences using both the CTRL and SH^" kev3 

* &eys are invalid and 

vill be ignored. 


'ey caps are narked so that 
-unctions are indicated as veil 


their normal 

as their CTRL and SHIFT 


functions, 


in nany.cases. 
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See the examples belov. 



CLZAR 



SE r^ function 
« 3 slightly differ¬ 
ed Ih?f^° n f ° r CSSL 

p.c rmaJL function 


In addition to the functions shovn, a .« of speoial 

characters are available as the rat functions of certain beys, 
as shovn on the next page. 


Ihe internal codes for all of the valid iey combinations and 
displayable characters are shovn in Appendix L. 
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The following functions apply to all data read from the keyboard. 


INVERT (H[ ) 


Toggles an internal switch that controls whether data beins: 
entered will be displayed in its normal or video inverse 
form. 


Caps Lock (SHIFT-CAPS) 

Alpha data entered will be in upper case form. 
(This is the power on default.) 


CTRL Lock (CTRL-CAPS) 

Alpha data entered will be in character graphics from. 


Unlock (CAPS) 


Resets either of the lock functions, if set. 
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Allows entry of the uppercase form of any data hey. This hey 
temporarily ower-ndes the Caps Lock and CTRL Loch settings. 

C haracter Graphic s Data ( CTRL-dat* lrayO 

Allows entry of the character graphics form of any data hey. 

“ 1 * ^ tM *° rarUy the Caps Loch and CTRL Loch 

settings. 


Special Cases 

CTRL-1 (Screen Editor Output Start/Stop) 

Allows the user to stop and resume text output to 
the screen; produces no user accessible ATASCII 
code, as it is a local function. 

CTRL-3 (Keyboard End-of-file) 

Returns an EOL character as data, with an END-OF- 
FILE status. 
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conver- 



Keys will be converted as they are input per the attached 

sion tables; where the column heading "L.C." stands for lower case, 

"U.C." stands for upper case, and "CTRL” stands for control- The 

following rules (which are ordered by priority) determine which 
column to use. 


1. If the SHIFT key and the CTRL key are both depressed, the 
keystroke vill be ignored. 

2. If the CTRL key is depressed, use the CTRL column. 

3. If the SHIFT key is depressed, use the U.C. column. 

k ' If the CTRL key is locked, use the CTRL column for A-Z and 
the L.C. column for all else. 

5. If the SHIFT key is locked, use the U.C. column for A-Z and 
the L.C. column for all else. 

Use the L.C. column. 


6 . 





and if the 


Alter the above stated conversion has been performed, 
resultant character is not a system function code, invert bit - 
the character if the "INVERT" flag is set (based on toggle of 

M key). 


\ 


7 of 
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KEYCODE TO ATASCII CONVERSION 
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4. SCREEN EDITING 


The keyboard and display may be logically combined for a mode 
of operation known as screen editing. While in this mode, many 

of the keys take on added function as described in the following 
paragraphs. 
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SCREEN EDITING FUNCTIONS 


\ 


Clsar Screen (CTRL-CLEAR, SHIFT-CLEAR) 

Clears all data from screen and places cursor at the home position. 
Insert Line (SHIFT-INSERT ) 

Moves the physical line in which the cursor resides, and all physical 

lines below that line, down one physical line. Note that the last 

* . 

logical line on the display may be truncated as a result. The new phy¬ 
sical line becomes the beginning of a new logical line. 

t . 

Insert Character (CTRL-INSERT ) 

Moves all data within a logical line, between the cursor and the end 
of the line, one position to the right, by inserting a space; the 
last character of the logical line will be lost when the logical 
line is full and an Insert Character is performed. 
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Delete Ling (SHIFT-ditt.T yrol 


Removes the logical line in which the cursor resides and moves 
all data below that line upward to fill the void. 

Delete Character (CTRL- DEL5TR ) 

Removes the character on which the cursor resides and moves all 

data to the right of the cursor (within the logical line) one 
position to the left. 

Cursor Up (CTRL- + ) 

4 

Moves the cursor up by one physical line; the cursor will wrap 
from the top line of the display to the bottom line. 











Cursor Down (CTRL-4 ) 


Moves the cursor down by one physical line; the cursor will wrap 
from the bottom line of the display to the top line. 

Cursor Right (CTRL- -») 

Moves the cursor right by one column; the cursor will wrap 
from the right margin of the display to the left margin (staying 
within the same physical line). 

Cursor Left (CTRL-**) 

Moves the cursor left by one column; the cursor will wrap from 
the left margin of the display to the right margin (staying 
within the same physical line). 
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Set Tab (SHIFT- TAB) 


Establishes the logical line position at which the cursor is 

residing as a tab point. The logical line position is different 

than the column position, as a logical line may be up to three 

physical lines in length. For example, tabs may be set at 

positions 30, 50, 73 and 85 as shown below for a mode 0 logical 
line. 



t-Ho 


HI- 90 


81 -' 2.0 


Clear Tab (CTKL-TAb) 


Clears the logical line position at which the cursor is residing 
as being a tab point. 
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Tab (TAB) 




Moves the cursor to the next tab point in the current logical line, 
or to the next logical line if no tab point is found. Note that 
this function will not increase the line length to accommodate a 
tab point outside the current length (e.g. logical line length 
is Uo characters and there is a tab point at position 60 ). 

Backspace (BACK S) 


Moves the cursor to the left one space (but not past the beginning 
logical line) and blanks the character at that position. 

Escape (ESC) 


Allows the .keystroke that follows to be entered as data, even if 
it would normally be interpreted as a control function. 




I 
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Carriage Return (RETURN) 


Allows the logical line within which the cursor resides to be sent 
to the program which is in control of the display. The entire line 
will be sent (with the exception of trailing blanks), no matter where 
the cursor is positioned within the line. After all of the data in 
the logical line has been read, the cursor will be positioned to the 
beginning of the next logical line. 

A special case occurs when characters are output without a terminating 
EOL, and then additional characters are appended to that logical line 
from the keyboard. When the RETURN key is pressed, only the keyboard 
entered characters will be sent to the program, unless the cursor has 
been moved out of and then back into the logical line, in which case, 
all of the characters will be sent. 

If the logical line sent uses the last physical line of the display, 
all of the screen data will be scrolled upward by one logical line. 
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CENTRAL INPUT/OUTPUT SUBSYSTEM USER'S DESC. 


1. Introduction. 

2. CIO Features 

3. CIO Command Overview 
4• CIO Comand Invocation Process - IOCB 

4.1 

4.2 

4.3 

4.4 

4.5 

4.6 

4.7 

5. Device Specific Information 

6* ften+ri rtinnir bI f\cce < 1 


Device 

« 

Command Byte 
Buffer Pointer 
Record Length 
Byte Count 
Command Status 
Auxilliary Information 
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1. INTRODUCTION 


The Central Input/Output subsystem (CIO) provides the user 
programmer with a single interface to access all of the system 
peripheral devices, in a (largely) device independent manner. 
In addition, the following high-level features are available: 


* Record or character aligned access 

* Automatic blocking and de-blocking 

* Concurrent access to multiple devices and files (non-overlapped) 

* Error detection and recovery built in 
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2 . 


CIO FEATURES 


This section describes the basic capabilities of the CIO - those 
that are device independent; the device specific features are 
discussed in section 5. 

2.1 DEVICE INDEPENDENCE 

CIO provides device independence by having a single entry- 
point and a device independent calling sequence; once a device 
fils is OPEHED, data transfer can occur with no regard 
to the actual device involved. Uniform rules for handling 
character and record transfers make the device block sizes 
transparent to the user. 

Status codes provided to the user are high-level numeric 
codes as described in Appendix C. 
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2. 2 RECORD ACCESS METHODS 


Two record access modes are provided by CIO-character aligned 
and record aligned. 

Character aligned accesses allow the user to treat the device 

— - - -****** . 

or fils 3.s 3 . character stream, ary number of* characters may 
be read or written and the following operation will continue 

^^®re the prior one left off• Records are of no consideration 

in this mode and reads or writes may encompass multiple records 

* 

if desired. 

Record aligned accesses allow the user to deal with the 
data stream at a higher level, that of the data record. 

Each and every write operation creates a record (by definition) 
and each read operation assures that the following read 
will start at the beginning of the next record. Record 
aligned accesses may not deal with portions of more than one 
record at a time. 

2.3 MULTIPLE DEVICE/FTLE norcHTJRRENCY 

Up to eight devices and files may be accessed concurrently 
using CIO, each operating completely independently of the 
others. 
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2 • 4 UNIFIED ERROR HANDLING 


AH error detection and error recovery occurs within the CIO 

sub-system and status information that reaches the user is in 
the form of a standard error number. 

3. CIO COMMAND OVERVIEW 

Thas section describes the seven basic I/O commands that are 
supported by all of the system devices. Other, device specific, 
co mma nds are described in section 5* 

3.1 OPEN 

Before a device may be accessed, it must be OPENED; this 
process links a specific. I/O Control Block (ICOB) to the 
appropriate device handler, initializes the device or file, 
initializes any CIO related control variables and passes 
any device specific options to the device handler. 

3.2 PUT RECORD 

The user provides a data buffer address and the buffer length; 
CIO then transfers data from the buffer to the device handler 
until one of the conditions shown below occurs, at which 
time the indicated action is taken. 
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PUT RECORD 


CONDITION 

ACTION 

1. EOL in buffer. 

1. Transfer EOL; 

return with normal 
status. 

2. No EOL in buffer. 

2. Transfer EOL after 
last data byte. 
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3-3 PUT CHARACTER(S) 


Tlie user provides a data buffer address and the buffer 
length; CIO then transfers the entire contents of the data 
buffer to the device handler. 

For the special case of PUTting one byte, the data may be 
passed in the A register instead of the user buffer if the 
buffer length bytes are set to zero. 


3 .k GET RECORD 


The user provides a data buffer address and the buffer 
length; CIO then transfers data from the device handler 
to the buffer until one of the conditions shown below 
occurs, at which time the indicated action is taken. 
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GET RECORD 
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3.5 GET CHARACTER(S) 


The user provides a data buffer address and the buffer length 
CIO fills the buffer with data from the device handler. 

For the special case of GETting one byte, the data is passed 
in the A register instead of the user buffer—if the buffer 
length bytes are set to zero. 

3.6 CLOSE 

To terminate all activity to a device or file, it must be 
closed. This process frees the associated IOCB, completes 
any pending data, PUTs and goes to the device handler for 
device specific actions. 


3.7 GET STATUS 

CIO calls the appropriate device handler which puts four 
bytes of device dependent status into system locations 
'DVSTAT' through 'DVSTAT'+3. 


NOTE: See Appendices H & I for the status byte formats. 
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k • CIO COMMAND INVOCATION PROCTERS 


The central element in performing I/O using CIO is the Input/Output 
Control Block (IOCB); all communication between CIO and the user 

regarding a specific operation is conveyed via this RAM resident 
structure. 

There are eight IOCB’s in the system which are arranged 
linearly in a table as shown below: 
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One 10CB is required for each currently OPEN device or file. Each 
IOCB may be used to control any of the system devices, although 
certain default assignments are made when the system is first 
powered up; namely, IOCB 0 is assigned to the screen editor (E:). 


The IOCB format with the system names is shown in Appendix A. 


A typical I/O operation is perforated by having the user insert appro— 
priate parameters into an IOCB, put the offset into the X register, 
and then JSR to the CIO routine. Upon return, the IOCB status 
byte may be interrogated to determine the degree of success 
of the requested operation. Status will also be in register Y. 

JM J1L -38 
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The individual parameters of the IOCB are described in the following 
paragraphs. 


U.l HANDLER I.D. 


The Handler I.D. is an index into the System Handler Table; 

provided by CIO as a result of an OPEN command and must 

not be altered by the user. This byte will equal FF-, for an 

16 

unused or closed IOCB. 

4.2 DEVICE NUMBER 

The Device Number is provided by CIO as a result of .an OPEN 
command and must not be altered by the user. 

4.3 COMMAND BYTE 

The Command Byte is provided by the user and is used to direct CIO 
and the device handler. 


The command byte value for each of the commands will be found in 
Appendix B. 


III-12 









k.4 STATUS 


The status byte is used by CIO to convey operation status to the 

user; see Appendix C for a list of the status codes. The general 
form of the status byte is shown below. 



k•5 BUFFER ADDRESS 


This two byte pointer is set by the user and is not altered by 

CIO. The user buffer has different uses for different commands 
as shown below. 

OPEN - contains device/filename specification 
GETXXX - receives data from device 
PUTXXX - provides data for device 

GETSTATUS — contains device/filename specification when device/ 

file not already OPEN. 

4.6 PUT ADDRESS 

This two-byte address is set to address-1 of the PUT byte routine 

of the device handler. This is provided by CIO as a result of an 
OPEN command and must not be altered by the user. 
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4•T BUFFER LENGTH/BYTE COURT 


This two byte count is set by the user to indicate the size of the 
data buffer; no more than the indicated number of the bytes will 

ever be transferred into or out of the buffer by CIO. Upon 

^_ 

return to the user, CIO will set this parameter to the number 
of bytes actually transferred. 

The return byte count may be less than the buffer length due to: 

1) errors, 2) end-of-file reached, 3) GET RECORD or 4) PUT RECORD. 

4.8 AUXILLIARY INFORMATION 

These two bytes are set by the user and contain information 

which is device dependent; these bytes are used during OPEN and 

in some of the device dependent commands to be explained in 
section 5. 

For OPEN, two bits of AUX1 are always used to specify the direction 
of I/O as shown below. 


- r - 

j 

~"1 - 

- 1 - 

- 1 - 

_l_ 

_ i _ 


i 

i 





-00 = no I/O allowed 
01 = input only 

10 = output only 

11 = input/output 


AUX1 should not be altered while a device is OPEN. 
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5. 


DEVICE SPECIFIC INFORMATION 


This section describes, for each device, the CIO commands that 
are supported and details any device specific characteristics. 

5.1 SCREEN EDITOR 


This device uses the keyboard and display to simulate a screen 
editing terminal. Writing to this device causes data to appear 
on the data display starting at the current cursor position. 
Reading from this device activates the screen editing process 
and allows the operator to do data entry and editing . 

Whenever the RETURN key is pressed, the entire logical line 
within which the cursor resides is.selected as the current 
record to be transferred by CIO to the user program. Trailing 
blanks are not transferred, however. When there is no active 
read to this device, screen editing may not be performed. 

See 1-15 and pages following for more information. 
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The symbolic device name of the screen editor is E 

and there is only one of them, so the device specification 

for OPEN is "E: 


AUX1, in the IOCB, is interpreted as shown below at OPEN 
time* 


0 


■ ■is . r 

•* 

T 

nr 

1 . » 

> 




input/output option 


The IOCB record length parameter may be any value, but 
the screen editor will always start a record at the 
beginning of a display line. Records will not be "packed" 
on the display unless they are multiples of 40 bytes in 
length. 

5.2 Keyboard Device 

This device allows the user to read the converted (ATASCII) 
keyboard data as each key is pressed. Key data are not 
buffered, so any key strokes, performed while there is not 
an active read to this device, will be lost. 

The symbolic device name of the keyboard is "K". There 
is only one of them, so the device specification for OPEN 
is "K:". 
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AUXI, in the IOCB, is interpreted as shown below at 
OPEN time: 


7 

- - -1— "i i-r 

UNUSED 

1 ‘ ~ f I 

»input/output option 

Note that the GET RECORD command does not provide editing 
of the data presented to the CIO caller; the caller gets 
every key stroke including editing keys and does not get 
any of the prior screen data. 

5.3 DISPLAY DEVICE 

This device allows the user to read characters from, and 
write character into, the display using the cursor as the 
screen addressing mechanism. Both text and graphics 
operations are supported. 



The symbolic device name of the display (screen) is f, S M 

and there is only one of them, so the specification for 

\ 

OPEN is "S:". 

AUXI, in the IOCB is interpreted as shown below at OPEN 
time: 



Due to hardware constraints, mixed mode is not allowed for 
Modes 9, 10, and 11. 
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AUX2, in the IOCB, is interpreted as shown below at OPEN 


time: 



screen mode (see below) 


The screen modes and their characteristics are shown below: 
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The mixed mode option modifies the screen mode selected 

to include four text lines of Mode #0 at the bottom of 

the display screen. In order to use mixed mode, both 

the screen editor (E:) and the display (S:) must be 

OPEN, and the display must be OPENed after the screen 
editor. 

The inhibit screen clear option allows the user to OPEN 
the display without clearing the display memory. Mode 
changes may make the display change even though the 
display memory is unchanged, however. 

Whenever display data are sent to the display, the cursor 
is moved after the data are put to the screen. If data 
are put to the lower right corner of the screen and'the 
cursor is not moved (as described on the next page), then 
the next data character to be sent will produce an I/O 
error and the cursor will be sent to the home position 
(even if the character is CLEAR SCREEN). 
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Certain functions of the keyboard/display handlers require the 
user to examine and/or alter system memory; the paragraphs that 
follow, give the standard names and brief descriptions 
of the use of the variables involved. 


COLOR REGISTERS 

COLOR 0 
COLOR 1 
COLOR 2 
COLOR 3 
COLOR U 


These variables contain cclor/lum values for the corresponding 
hardware registers. The RAM data is sent to the hardware as 
part of the system VBLANK interrupt processing. 

CURSOR 

ROWCRS 

* 

COLORS double byte: LO, HI 

These variables may be examined to determine the current screen 
cursor position or may be altered to force the cursor to a new 
position. When the cursor values are changed, the cursor will 
not move until the next I/O operation involving the display. 

The oeccnd byte (HI bits) of* COLORS will always be zero except 
when the screen is in mode 8. 
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When the screen is in a split screen configuration, a 
separate pair of cursor registers are used to control 
the text regions cursor at the bottom of the screen. 

TXTROW 

TXTCOL double byte: LO, HI 

The upper left corner of each of the two split regions 

is defined as 0,0 for the region's associated cursor. 

CURSOR INHIBIT 

CRSINH 

When this flag is set non-zero, the text cursor will not 
display. 



Ill- 21 



DISPLAY FLAG 


DSPFLG 

This variable is used to specify whether control characters sent 
to the display are to be displayed as special graphics or pro¬ 
cessed normally (and not displayed). 

DSPFLG ^ 0 , display and don't process 
- 0, process and don't display 

CHARACTER SET SELECT 

CHBAS 

This variable selects either uppercase and numbers or lower 
case and character graphics as the character set when in one 
of 20 character text modes (l or 2). 

CHBAS = E0^g for upper case and numbers 

s E2 g for lower case and character graphics 

NOTE: CHBAS is restored to E0^ when any screen or editor mode 

is OPENed. 
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keyboard data 


CH 

Key data that has been entered from the keyboard is stored 

111 01 (by the interr ^Pt service routine); when the data is 

later seen by the keyboard handler, CH is set to FF (an 

. 16 
invalid key code). 

If the user wants to monitor for keyboard activity, but not 

to give up control until the next keystroke, he monitors CH 

until it is not equal to FF and then initiates a GET CHARACTER 

I/O call from the K:device to get the ATASCII data. Note that 

CH contains the keyboard matrix code, not the ATASCII code for 
the key stroke. 


MARGIN CONTROL 


LMARGN 


RMAEGN 


LMARGN establishes the left margin of the screen for Mode 0 only. 
Tbe minimum value is zero and the system default val u e is two. 
RMARGN establishes the right margin of the screen for mode 0 

The maximum meaningful value is 39; if the value is larger 


only. 


than that, it will be treated is if it were 39 anyway 
system default value of RMARGN is 38 . 


Th< 


When in effect, the margins define the 

display; the cursor (and hence the data 
bounds defined by the margins. 


accessable portion of the 
) is limited to the inclusive 
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Data going to or from the display, when in one of the graphics 
modes, is in one of the formats shown below: 


7 


—r —t -i—|—i- 1 - 

XX X X X X X 

D 



1 » 1 1—'- 

X X X X XX 

D 

D 


i * r 

X X X X 

D 

D 

D 

D 


Modes 4, 6, 8 

Modes 3, 5, 7 
Modes 9, 10 ) 11 


D = "DATA" 

X = "DON'T CARE" 


The DATA portion (D) contains the bit(s) corresponding to a single 

a 

pixel. Two exceptions to the DON'T CARE bits are CR(9@ l6 ) and CLEAR 
SCREEN (7D.,). If their code is sent to either E: or S:, they will be 
performed. Any data from the display, however, will have all DON'T 
CARE bits zeroed. 


As graphics data are read/written, the cursor moves to the position after 
the last accessed pixel (as in text mode). Thus, a PUT of multiple char¬ 
acters will draw a horizontal line segment or a horizontal band. 


In addition to plotting data point by point, two special commands are 
available to perform higher level functions: DRAW and FILL. 


DRAW 

This function draws a "straight" line from the actual cursor 
location to the location specified in ROWCRS and COLCRS. The 
I0CB command byte = 11., g and other user settable portions of 
the IOCB are not used. The color of the line drawn is the same 
8S the last pixel updated prior to the DRAW command. 


HI* 24 



















At the completion of this command the actual cursor will be at 


the location specified in ROWCRS and COLORS. 


FILL 

FILL is a special function used to fill in areas of back ground 
with a specified color. The command is setup similar to DRAW, 
but as each point of the line is drawn, the rountine scans to 
the right performing the procedure shown on the next page. 

FILDAT contains the fill data and ROWCRS and COLCRS contain the 
cursor coordinates of the line endpoint. The IOCB command 
byte = 12.g and other user settable portions of the IOCB are 
not used. 


\ 
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FILL Line Scan 


i 



ic 

End of line wraps to beginning of same line. 
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FILL example 







4 

5 


i 

> 

* 


(D. - Set cursor and plot point 
(D- Set cursor and DRAW line 
(2)~ Set cursor and plot point 

- Set fill value, set cursor, and FILL. 



/ 
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KEYBOARD/DISPLAY DATA FORMATS 


Mode 0 


Modes* 
1 & 2 


Modes 

3,5,7 


Modes 

4,6,8 


Modes 

9,10,11 


^NOTE: 


^• Keyboard Data (mode independent) 
7 0 


r i « • • i i « 

LI « i_i » » « 


OR 




TASCII Data Code 
Inverted Video 




/ 

.. 0 

til.1 1 

I UNUSED I 



/ 

I ""* * » I 1 » I 

UNUSED I 

- > * * , I 1 1 


7 


i * i 


UNUSED 


l t » * 

1..... 1 i 1 



TASCII 
ontrol Code 


OR 


ATASCII Data Code 
Inverted Video 



OR EOL OR CLEAR SCREEN 

Truncated ATASCII 
Color Select 

OR EOL OR CLEAR SCREEN 

Color Select 



OR EOL OR CLEAR SCREEN 


Color Select 


OR EOL OR CLEAR SCREEN 


Color, Lum or Register Select 


4 C character + color select — 10 is indistinguishable from 
an ATASCII EOL. 
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Printer 


This device prints ATASCII characters, a line at a time; 
it recognizes no control characters and neither does 
it's handler (except for EOL)* See Appendix I for the 
printer character set. 

The symbolic device name of the printer is P. The 
specification for OPEN is "P: M . 


AUX2* in the IOCB, is used in conjunction with the 
write commands to specify one of three modes as shown 
below: 



I -- print mode 

00 OR UE^g( f N’)s normal (40 upright characters) 

53ig( f SV)= sideways (l6 sideways characters) 


IOCB, is interpreted as shown below at OPEN time. 


7 0 
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5.5 


Cassette Device 


The cassette is a read/write device OPEN either for reading 
or writing but never both, as all output files start at (or 
define) the logical end of tape. 

The symbolic device for the cassette is C and there is only 
one of them, so the device specification for OPEN is M C: fr . 

AUXI, in the IOCB, is interpreted as shown below during the 
OPEN operation. 


r-a 


1 "■*' 1 » 

UNUSED 







00= invalid 

I- 0 1 = OPEN input 

10= OPEN output 
11= invalid 

AUX2: 00 normal IRG mode ' 

80 short IRG mode 

In short IRG mode, the tape does not stop throughout the 
reading/writing of the entire file; on reading, if read 

requests are not made within a certain time frame, data will 
be missed. 
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5 • 6 DISK File Manager (FMS) 


The symbolic device name for the disk is D and there may 
be up to 4 of them, so the device specification for OPEN 
is "D : < filename^EOL" where 4^filename>is a 

string of up to 12 characters. If is not specified, 

it defaults to the value 1. 

AUX1, in the IOCB, is interpreted as shown below during 
the OPEN operation. 


0 


p f r 

UNUSED 

- 1 _i L 












append (when OPEN output) 

•list directory (when OPEN input) 



00 = invalid 
01 = OPEN input 

10 = OPEN output 

11 = OPEN INPUT/OUTPUT 


The "append" option is used to add data to the end of an 
existing file. 

The "list directory" option allows the caller to read 
directory information using normal GET RECORD or GET 
CHARACTER commands: the information will be in Atari ASCII 
suitable for outputting to any other device (i.e. formatted 


for display or print). 
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The Disk File Manager provides several commands which are unique 
to this handler and reflects the multiple file organization of 
the disk. These commands are: 


RENAME file(s) 


DELETE file(s) 


LOCK file(s) 


UNLOCK file(s) 


RENAME - allows the user to change the name of any of a number 


of named files; the FMS expects to find a device 
specification plus a second name in the user buffer, 
as shown below: 



All occurrences of the first filename will be replaced 


with the second filename (using the wildcard rules as 


explained on page III—4SP35. No protection is provided 

against forming duplicate names, and once formed, 

% 

duplicate names cannot be separately RENAMED or DELETED; 
however, an OPEN command will always select the first 
one found so that one of the duplicates is always 
accessible. The RENAME command does not alter the con* 
tent of the files involved, merely the name in the 
directory. 
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DELETE 


LOCK - 


UNLOCK - 


The Disk 
used for 


NOTE - 


allows the user to delete any number of named files from 
the disk directory and deallocate the disk space used by 
the files involved. The FMS expects to find a device 
specification in the user buffer; all occurrences of the 
filename will be deleted (using the wildcard rules as 
explained on page III-35). 

allows the user to limit access to any number of named 
files. The FMS expects to find a device specification 
in the user buffer. LOCKED files may not be DELETED, 
RENAMED, nor OPENED for output until UNLOCKED. LOCKing 
a file that already is LOCKed is a valid operation. 

allows the user to remove the LOCK status of any number 
of named files. The FMS expects to find a device speci¬ 
fication in the user buffer. UNLOCKing a file that 
is not LOCKed is a valid operation. 

File Manager also provides two more commands that are 
random access to the disk: 

NOTE disk address 
POINT to disk address 

returns to the caller two values that together give the 
exact location of the next byte to be read or written. 

The absolute disk sector number is returned to the IOCB 
in ICBLL (LSB) and ICBLH (MSB) and the absolute displace¬ 
ment within that sector is returned in ICBAL. Note that 
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operation, those 


POINT 


before performing the next I/O type of 

IOCB parameters should be re-established 
address and length values. 


3s memory 


-ts tne current file position to the exact disk address 
specified; the next byte read or written will be from 
or to that location. The absolute disk sector number 
is expected in the IOCB in ICBLL (LSB) and ICBLH (MSB) 
and the absolute displacement within that sector is 
expected in ICBAL. Note that before performing the next 
I/O type of operation, those IOCB parameters should be 
re-established as memory address and length values. 
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DISK FILENAME FORMAT 



The filename portion of the device specification for the disk file- 
manager is of the form. 



PPPPPPPP• xxxx , where: 


PPPPPPPP * primary file name. The first character must be aplha. 

following 0 to 7 characters may be any alphanumeric 
characters.^ If the primary name is less than eight char¬ 
acters it will padded to eight characters with blanks. 

xxxx » file name extension used to classify the file type. If 

no extension name is given, the extension will default to 
blanks. If the extension name is given, then the first 
character must be an alpha.' 

The following 0-3 characters must be alphanumeric. 



File Name Searching 

The filename supplied by the user to FMS may contain certain "wild 
CARD characters. These wild card characters allow the file name to 
be abbreivated. The ? character anywhere in the. filename allows 
any character to be a match. .For Example A?C is equivalent to 
ABC or AXC or A1C etc.. The * character causes the remainder of 
the primary or extension field to be padded by the ? characters. 

For Example, AB* would be transfored to AB??????. The filename 

AB, ABC, ABCDE, ABCDEFGH would all be found if AB* is designated. 
*.* represent any filename. 
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DISK FILENAME WILDCARDING 


The following disk commands act upon only the first file (if any) 
that matches the specification: 

OPEN (input, output or input/output) 

GET STATUS 


The following disk commands act upon all files (if any) that match 
the specification: 

DIRECTORY LIST 

DELETE 

RENAME 

LOCK 

UNLOCK 
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5.7 Flo 


DiskDeyice 


This device is not accessed.through CIO except 

through the DISK File Manager* se~ r™ 

ger, see the USER PROGRAM/ 

DISK HANDLER INTERFACE MANUAL for information relating 
to reading & writing sectors from the floppy disk 
in a non-file-oriented manner. 
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Direct Device Handler Access 

In some cases, it may be desired to access a device handler directly, 
bypassing the CIO interface. This is a straightforward thing to do, 
for the system resident handlers have vectors in ROM for all of their 
entry points. For each handler there is a set of vectors ordered as 
shown below: 


LO Address 


HI Address 


- 

OPEN vector 

i 

- 

j 

CLOSE vector 

\ 

- 

GET BYTE vector 

-4 

* 

{ 

- 

PUT BYTE vector 

- 

- 

GET STATUS vector 

— 

- 

SPECIAL vector 



JMP 

I 

' 

IN IT 

- 




All vectors contain 
the true address minus 



Because the vectors contain the true address minus one, a technique 
similar to the following one is required to access the desired routines. 


LDX # vector offset Index to desired routine 

JSR GOHAND 


GOHAND TAY 
LDA 
PHA 
LDA 
PHA 
TYA 
RTS 


Save data in Register A. 

Base addr + 1, X Push routine address to stack 

Base addr, X 



Effects a JMP 
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The base addresses for resident 

Screen Editor — 
Display - 

Keyboard - 

Printer 

Cassette - 


system handlers are shown below: 
E400 5d3(o% 

E410 

E420 

E430 

E440 
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USER PROGRAM/Disk Handler 


1. Introduction 

2. Disk Handler Command Invocation Process -dcb 

3. Disk Handler Commands 
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1. INTRODUCTION 


The user program will use a non-CIO calling sequence to access the 
disk handler. This special call will pass parameters in the system 
Device Control Block (DCB) rather than in an IOCB. 


2. DISK HANDLER COMMAND INVOCATION PROCESS 


The system's single DCB is formatted as shown "below (note the resem¬ 
blance to IOCB format). 
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DCB 


| SERIAL * 

| BUS I.D. 


1 DRIVE # l- n 

• 

COMMAND 

STATUS * 


BUFFER r „ 

LO 

ADDRESS 

I DISK * 

TIME OUT 

| UNUSED 

BYTE * „ 

1 LO 

COUNT ^ 

HI 

SECTOR T „ 

- LO 

NUMBER __ 

L-. 


The user will insert the non-starred items into the DCB and JSR ^£453 

Dpon return, the status byte vill indicate the de e r,e of success 
Of the requested operation. 


The DCB parameters are described 


in the filloving paragraphs. 


•Need not he supplied by caller - vill he filled in by dish handler. 
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2.1 SERIAL BUS I.D. 



This number is inserted by the handler and contains the bus address of disk 

drive #1. It is of use only to the Serial Bus I/O Routine 
(SIO). 


2.2 DRIVE NUMBER 



This indicates which disk drive to access and i 


is a number ranging 


from 1 to 4. 

2.3 COMMAND BYTE 

This indicates to the disk handler which command to perform 
(see section 3.)• 

2 .U BUFFER ADDRESS 

This two byte pointer indicates the source or destination of 
disk data and status information. For disk status commands, the 
user need not supply an address. The disk handler will insert the 
address of the global status buffer. 
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2.5 DISK TIMEOUT 

This timeout value (in whole seconds) 
disk handler for use by the SIO routine. 


is supplied by the 


2.6 BYTE COUNT 

This count indicates the number of bytes transferred into or out 
of the buffer as a result of the most recent operation. 


2.7 STATUS 


sxo 


This system level I/O status is set by tr O as a 
result of the most recent operation. 


2.8 SECTOR NUMBER 

This two byte number indicates to the disk handler which single 

. 

sector to read or write (for read and write commands only). 
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3- DISK HANDLER COMMANDS 

This section describes the dish commands available to the caller: 

GET SECTOR 
PUT SECTOR 

PUT SECTOR - WITH READ CHECK 
STATUS REQUEST 
FORMAT DISK 


3.1 ■ GET SECTOR (Command Byte = 52) 

The disk handler gets one sector's worth of data and puts it into 
the supplied buffer. 


Status will be as shown in Appendix F. 


3.2 PUT SECTOR (Command Byte * 50) Same as 3.3 except no read check. 

» 

3.3 PUT SECTOR - WITH READ CHECK (Command Byte - 57) 

The disk handler puts one sector*s worth of data from the supplied 

buffer to the disk. The disk will do a read after write check. 



Status will be as shown in Appendix F • 
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3*4 STATUS REQUEST (Command Byte = 53 ) 


The disk h a n dler gets a four byte status from the disk controller 
and puts it in system location f DVSTAT f . 

Operation status will be as shown in Appendix F* 

The disk controller status format is shown in appendix H. 

3*5 FORMAT DISK (Command Byte = 21) 

The disk handler commands the disk controller to format the entire 
disk and then to verify it. All bad sector numbers, up to a max¬ 
imum count of 63, are returned and put in the supplied buffer— 
followed by two bytes of all ones (FFFF g ). The Byte Count 

parameter in the DCB will indicate the number of bytes of sector 
information in the buffer.(Equals number of bytes received; always 128) 

Operation status will be as shown in Appendix F. 
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CIO/HANDLER INTERFACE GUIDE 


Introduction 

Central Input/Output Subsystem Structure 
Handler Entry Points (Commands) 
Non-resident Handlers 
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1 . 


Introduction 






This document describes the interface between the Central 
Input/Output Monitor (CIO) and the individual device handlers 
and file managers that communicate with CIO. Almost all 
I/O operations are initiated via CIO, as that provides the 
most general view (largely device independent) of the I/O 
subsystem. CIO is entirely responsible for managing: 

1. Record handling 

2. User buffer maintenance 

3. Logical to physical device mapping 

• & 

The device handlers and file managers are then responsible 
for managing: 

1 . device buffering 

2 . input and/or output of a serial byte stream 

/ 

3. conversion of device status to system level I/O status 
U. device specific aspects of OPEN & CLOSE commands 

5. device specific commands 
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2. 


Central Input/Output Subsystem Structure 


The I/O subsystem is organized as shown below, 
where represent structural elements and 

represent processes 





L 


1 



J- 



x/o 



ComtroC 

1 %<OCl<jC5> 





PRo<xR A N\ 




CXO 
H OK» ITO R. 



4 

T 

- 

£,.f. 

W' \ 

A-+ . 

X' 


OLCK 


f 


U fcl-SJC 

(V H-ftAJOLcR. 

\^—7T7c 


/ 


/ 




Fi 


T 

if 



Hffa'OUstl. 


v\ 


V 


UlO Monitor.] 
S3TO^ 



tty 

OiSPc/Vy 
t+nr^OLe-; 
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The user program initiates an I/O operation using 
one of the system I/O Control Block (iOCBs); 
one is required for each device or file to he 
concurrently accessed. The CIO monitor examines 
the command hyte in the IOCB and resolves it to 
one of six handler level commands: 


1. OPEN 

2. GET NEXT BYTE 

3. PUT NEXT BYTE 

k . GET STATUS 

5. CLOSE 

6 . SPECIAL (device specific) 


Each handler has seven entry points which are organized 

i 

as a table of vectors, as shown below: 


HANDLER 

VECTOR 

TABLE 



— OPEN VECTOR 

-] 


— GET 3YTE VECTOR 

1 

4 


_ PUT BYTE VECTOR — 

/ 

— GET STATUS VECTOR 

/ 


_ CLOSE VECTOR 



SPECIAL VECTOR 

~ ) 

> 

INITIALIZATION CODE 

Tor JMP to same) 

HANDLER 

BODY 

\ 

X > 


Vectors are defined 
as the proper address 
minus 1. 
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The function of each of the seven vectored entry 
points will he described in detail in Section 3, 
but for now let's say that the handler acts upon 
the indicated command (examining the IOCB where 
necessary) and returns a system I/O status when 
the operation is complete. Communications to lower 
level handlers require additional structures such 
as the Device Control Block (DCB) or File Control 
Blocks (FCB). These details are covered in another 
called the SIO/HANDLER INTERFACE GUIDE. 


3. Handler Entry Points (Commands) 

There are seven entry points for each I/O ha nd ler, 
each entry point corresponding to one or more co mman d 
activities; the ClO/handler interface for each entry 
point will be described in the following paragraphs. 


1 


< 


I 


document 


I 
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Data will be passed between CIO and the handler using the machine 
registers and a single I/O Control Block in page 0 (called ZIOCB), 
see Appendix A for the IOCB format. 



Register A is used to pass device data, register Y is used to pass 
status information and register X contains the index to the originating 
IOCB. Upon any I/O call, CIO moves the indicated IOCB, in its entirety, 
to the zero page IOCB before calling the device handler; before returning 
to the caller, CIO moves the ZIOCB back to the originating IOCB.* Most 
handlers will have no need to access the originating IOCB, but will use 
the zero page copy. Also, handlers need not have the IOCB index in 
register X upon return to CIO. 

* In the course of processing a given command CIO may alter the buffer 
address and buffer length paramaters in the ZIOCB; so, if the original 
values of these are required, they must be obtained from the external 
IOCB. 
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3.1 


Initial!zation 


This entry will be called after initial power-up 
and after a system RESET: the handler 

should perform whatever initialization is required 
of its hardware and of it's RAM data to insure 
proper processing of all CIO commands that follow. 
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3.2 


OPEN 




At handler entry, the IOCB parameters of interest will 
be: 

Device Number - Contains 1 - n (for multi-device 

handlers) 

Command Byte - OPEN command 

Buffer Address - Points to file name specification 

(See Appendix D) 

Auxilliary Inf. - Indicates OPEN direction 

Contains device specific information 

The handler will attempt to perform the indicated 
OPEN and will signal the success of the operation 
by returning an IOCB status in register Y (See Appendix C). 

The responsibility for checking for multiple OPENs 
to the same device or file, where it is illegal, lies 
with the handler or file manager, not CIO. 

File managers will return file status in the 
Auxilliary Information Bytes (see Appendix I). 
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3.3 GET Next Byte 

At handler entry, the IOCB parameter of interest will be: 

Device Number - contains 1 - n (for multi-device 

handlers) 

/ 

The handler will get a byte of data from it's device buffer, 

if one is available, or else initiate a read to the device 
to get more data. 

Handlers that do not have timeouts associated with reading 
data, such as Keyboard and Cassette, must monitor the system 
BREAK flag and set the appropriate status and return when 

a BREAK condition occurs before data is available. 

/ 

When the data byte is available, the handler will return 
to CIO with the data in register A and the status in 
register Y. 

CIO checks for reads from devices or files that have not been 
OPENed, or OPENed for output only; the handler will not be 
called in those cases. 



V - 9 




3.4 Put Next Byte 


At handler entry, the IOCB parameter of interest will he: 

Device Number - contains 1 - n (for multi-device 

handlers) 

The handler will put the byte of data in register A into 
it's device buffer or send the data to the device. 

When device buffers fill, they are sent to the 
device before returning to CIO. 


The handler will return to CIO with the status in 
register Y. 


CIO checks for writes to devices or files that have not been 
OPBed, or OPENed for input only; the handler win not be 


called in those cases. 
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3# 5 Get Status 


At handler entry, the IOCB parameters of interest will 
be: 


Device number 

Buffer address 


contains 1 — n (for multi—device 
handlers) 

points to filename specification if device 
not already OPEN. 


The handler or file manager will get device status from 
the device controller and put the status bytes (maximum 
of four) in system locations "DVSTAT" through "DVSTAT + 3”. 




TL.e uandler vill return to CIO with the operation 
status in register Y. 

Note that a device or file need not be OPEN to 
perform a GET STATUS operation. 
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3.6 


CLOSE 


At handler entry, the IOCB parameter of interest will be: 


Device number 


contains 1 — n (for multi—device 
handlers) 


The handler will release any held resources that relate 
specifically to that device or file, and for OPEN outputs: 
1) send any remaining data in local device buffers to 
the device and 2) mark the end-of-file. The handler 
will also mark the device as not OPEN and take any 
other device specific action normally associated with 
CLOSE. CIO will mark the IOCB as not open. 
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3.7 


Special 


This handler entry is used to support all functions not 
handled by the other entry points, such as file RENAME, 
file DELETE, etc. The handler will interrogate the IOCB 
Command Byte for legality and perform the indicated 
command, if possible. 

The handler will return to CIO with the operation status 
in register Y. 

Devices need not be OPEN nor CLOSED to perform special op¬ 
erations using CIO; the handler must check, where there are 
restrictions. 
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4. 


Non-Resident Handlers 


Non-resident handlers reside in cartridges, disk or RAM and 

are known to the CIO subsystem only if they have an entry in 
the System Handler Table. 

This table contains the names and addresses for each of the 

devices supported by the system. The table is configured at 

power-up time to contain entries for the ROM resident system 
handlers. 


The table format is shown below: 


"HNDTAB" 


DEVICE NAME 


(ASCII) 


HANDLER 


_ VECTOR 

L0_ 

TABLE 


ADDRESS 

HI 

! ENTRIES 




ZERO FILL TO 
END OF TABLE 




One Entry 


i 


Power-up adds entries to the table starting with the beginning 

(low address); CIO scans the table from the end to the begin- 

• Thus, in the case of multiple handler entries for a 

given device, the entry nearest the end of the table will be 
selected. 


The table has room for ten entries, five of which are filled at 
power-up time (with K:, Es, S:, C:, and P:); the disk handler 
will optionally take one more entry (D:). 
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To install a new handler, some procedure must place the 
symbolic device name and the handler vector table address 
into the System Handler Table. This is the responsibility 
of the program supplying the handler. The installation 
can occur at cartridge initialization (for cartridge resi¬ 
dent handlers), but may be deferred until later, if desired 
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Handler/SIO Interface Guide 


1. Introduction 

2. Central Input/Output Subsystem Structure 

3* Handler/SIO Interface 

h. SIO Operation 
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1 . 


Introduction 


This document describes the interface between the serial bus 
device handlers and the serial I/O Bus Monitor (SIO). All bus 
transactions are initiated and terminated by SIO following a 
bus protocal that is device independent; this protocol is 
defined in the SIO BUS PROTOCOL DESCRIPTION document. 

SIO is responsible for handling:- 

1 . 

2 . 

3. 

4 . 


Serial bus protocol and chip management 
Error retries 
Time-out functions 

Data transfer between handler buffers and the 
serial bus. 
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2. 


Central Input/Output Subsystem Structure 


The I/O subsystem is organized as shown below. 


where 



represent structural elements and 


c 


J represent processes. 
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The handler initiates an I/O operation using the 

system Device Control Block (DCB) to pass parameters 

to and from SIO. The parameters are described in the 
next section. 

3. Handler/SIO Interface 

The Device Control Block is ronnatted as shown below: 


SERIAL BUS I.D. 


UNIT § (1-n) 


SERIAL BUS 

COMMAND 


STATUS 


HANDLER 

BUFFER 

LO _ 

ADDRESS 

HI 

DEVICE TT WROTH 1 

NOT USED 


__ BYTE 

LO 

COUNT 

HI 

__ .. - 

AUXILLIARY 

“ DATA 
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Tlie DCB parameters are described, in the following paragraphs. 


3.1 Serial Bus I.D . 

This must contain the Serial Bus address of unit #1 of the 
device to be accessed. 

3.2 Unit Number 

This indicates which of n units of a device type to 
access. SIO will access the device number calculated 
by adding the Serial Bus I.D. to the Unit Number and 
subtracting one. 

3.3 Serial Bus Command 

This byte will be sent to the device controller as part 
of the serial bus command frame. 
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3*1+ Status 


The status byte is bi-directional; the handler will 
use it to indicate to SIO what to do after the command 
frame is sent and SIO will use this byte to indicate the 
status of the operation. 

Prior to SIO call: 


7 


0 


UNUSED 



00 = no data transfer associated 
with operation. 


01 = data expected from device 
10 = device will expect data 


11 = invalid 


After SIO call: 


7 


0 


J_ L 


—i—i—i— r i 

STATUS # 


See appendix G for status codes 
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3.5 


Buffer Address 


Tliis two byte pointer indicates the source or destination 
of device data and status information. 

3.6 Device Timeout 

This timeout value (in .whole seconds) defines the 
maximum allowable time to wait for any single command 
attempt . 

3.7 Byte Count 

This count indicates the number of bytes to transfer into 
or out of the buffer for the current operation. Not used 
if STATUS byte indicates that no data transfer is to take 
place. 

% 

3.3 Auxilliary Data 

These two bytes are included in the Serial Bus command 
Frame by SIO; they have device specific meanings. 
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SIO Operation 


k. 


SIO's operation is represented by the flowchart below; 
this applies to all devices except for the modem and 
cassette, which are special cased. 
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SERIAL I/O BUS PROTOCOL 
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Current Devices 







2. 


Bus Command Types 





The Serial Bus Protocol accomodates three basic types of 
commands: l) data send, 2) data receive, and 3) immediate 
(no data - command only)* 

The common element in all three command types is the command 
frame, five bytes of information sent while the COMMAND line 
is held low* 

The command frame format is shown below: 


S€£- li'Vc.'EO-S 

Deuxcfa □c.t*. 

/K)xvu_» 

Ci4€C!CSO 


The flowchart on the next page shows a typical device controller’s 
processing of a command frame. 
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Following the command frame is an optional data frame which 
is formatted as shown below: 




This data frame may originate at the central processor or at 
the device, depending upon the command. The flowchart on 
the next page shows a typical device controller’s processing 
of a data frame from the central processor. 
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The flowchart at the bottom of this page shows a typical device 

controller’s processing of a data frame to he sent to the central 
processor. 
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The flowchart at the bottom of this page shows a typical 
device controller’s of an "immediate" type of command 
- no data frame* 
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All checksums used as part of the serial bus protocol are 
simple 8-bit arithmetic sums using the carry bit, as shown 
below: 
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3. 


Bus Timing 


The serial Bus Protocol accomodates three basic types of 
commands: l) data send, 2) data receive, and 3) immediate 
(no data frame). A timing diagram is given below for each type: 


X) o *3 


cm 



to (command frame initiate delay) 
t^ (command frame acknowledge delay) 
t 2 (controller data receive setup time) 
t^ C data frame acknowledge delay) 
t^ (operation complete) 


= 100 usee - 500 usee 
= 0 - 500 usee 
= 250 u - 1 sec, 

= 150 u - 15 msec. 

= 150 u - 00 
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h. 


Current Devices 


This section provides information on the two current intelligent 
serial bus devices, the 40 column printer and the floppy disk. 

4.1 Printer (i.D. = 40 ) 

16 

The printer controller recognizes two commands: 

WRITE and STATUS REQUEST. 

4.1.1 The printer WRITE command frame contains the following 
values: 


Command = 57ig 

Auxilliary Byte 1 = print option 

Auxilliary Byte 2 =• undefined (not used) 

Auxilliary Byte 1 (AUX1) will contain one of the following 
values - 

^ E l6 = Normal, print (40 chars/line) 

^ 3 16 = Sid eways print(l6 chars/line) 

The printer WRITE data frame contains either 29 data bytes 
plus a checksum byte, or 40 data bytes plus a checksum 
byte, depending upon the value of AUX1 in the command frame. 
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4.1,2 The printer STATUS REQUEST command frame contains the 

following values : 

Command = 53-^g 

Auxilliary Bytes = undefined (not used) 

The printer controller will return the status as a 
valid data frame as shown below. 




FLA<SrS 

/=KJXl F^4»K\ LA^TT* 
EXT g Comm /Vn) 

DATA WRITE 

Timeout _ 

CHECKSUM 



The FLAGs byte contains information relating to the most recent 
command prior to the STATUS REQUEST and some controller constants. 
The FLAG byte is formatted as shown. 
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PUWS 



OnjvjS D 





pirevious 

invalid 

pv^viiou^ 


C<3Vvi L\i jum, <£ ^VA^iyu L^ UJCLS 


d a l“7X--/vau* r 
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v^Ccsy* r2£-S SOL 


Data Write Timeout = maximum time to print a line of 

data assuming worst case controller 
produced cool-off delay. 

(l sec.) 
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k.2 Floppy Disk Controller (i.D.s = 31-34-^) 


The floppy disk controller recognizes commands: 

READ, PUT, WRITE, FORMAT, and STATUS REQUEST. 

4.2.1 The disk READ command frame contains the 
following values: 


Command = 52^g 

Auxilliary Byte 1 = Disk Sector L.S.B 
Auxilliary Byte 2 = Disk Sector M.S.B 



( 


The disk READ data frame contains 128 bytes of data 
plus a checksum byte. 


4.2.2 The disk PUT command frame contains the 

following values: 


Command = 50 


16 


Auxilliary Byte 1 = Disk Sector L.S.B.' 
Auxilliary Byte 2 = Disk Sector M.S.B. 


( 1 - 


4.2.3 The disk WRITE command (read after write check) frame 
contains the following values: 


Command = 57 


16 


Auxilliary Byte 1 = Disk Sector 
Auxilliary Byte 2 = Disk Sector 



(1 


1 - 720) 


720) 


-720) 
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The disk WRITE data frame contains 128 bytes 
of data plus a checksum byte<, 

U.2. 4 The disk FORMAT command frame contains the following 
values: 


Command = 21^g 

Auxilliary Bytes = undefined (unused) 

The disk FORMAT data frame (returned by the controller) 
contains 128 bytes of data plus a checksum byte, formatted 
as shown below: 
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The disk is formatted and then verified by the disk 
controller; the FORMAT data frame contains from zero 
to 63 bad-sector numbers, followed by two bytes of all 
ones, followed by fill bytes : to pad 

out the data block to 128 bytes, followed by a checksum. 
The sector numbers may be in any order. 

The disk STATUS REQUEST command frame contains the 
following values 

Command = 53 , 

16 

Auxilliary Bytes = undefined (unused) 

The disk controller will return the status as a 
valid data frame as shown below. 
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The FLAGS byte contains information relating to 
the most command prior to the STATUS REQUEST, and 
is formatted as shown. 



Worst case timeout 


maximum time to wait for 
slowest operation (FORMAT). 
(1 sec.) 
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Appendix A - IOCB Format 


INITIATING 
IOCB NAME 






y 


ZERO-PAGE 
IOCB NAME 


HANDLER I.D. 

i 

* 


I CHID 

ICHIDZ 

DEVICE # 

* i 

• 

_L 

ICDNO 

ICDNOZ 

COMMAND 


ICCOM 

ICCOMZ 

STATUS 

* 


ICSTA 

ICSTAZ 

BUFFER 

LO 


ICBAL 

ICBALZ 

ADDRESS 

HI 


ICBAH 

ICBAHZ 

PUT BYTE 

LO* 

L_.__ 

ICPTL 

ICPTLZ 

ADDRESS 

HI* 

f U 

ICPTH 

ICPTHZ 

BUFFER 

LO 


ICBLL 

ICBLLZ 

LENGTH 

HI 


ICBLH 

ICBLHZ 

AUXILLIARY 

1 

LO 


ICAX1 

ICAX1Z 

INFORMATION 

HI 


ICAX2 

** 

ICAX2Z 

^Supplied by 

CIO , not calling program 


$0:4? 

X 0* 

£ t 

<p /I y S /ntf 

/- / 

■ Ip* A 

<?'2 50 

n 

1 


0 3 & $ 

if 

z 



i ( 

3 



a 




u 

5 


0 i /)<h 

ti 

c 


<3 3^ 

1 

1 




jr> 

4 jk 

i $/ 


f 


A 


t O f i u t 
























Appendix B - IQCB Command Bytes 








03 


OPEN 

05 

- 

GET RECORD 

07 

- 

* 

GET CHARACTER(S) 

09 

- 

PUT RECORD 

0B 

- 

PUT CHARACTER^) 

0C 


CLOSE 

0D 

- 

STATUS REQUEST 

20 

- 

RENAME 

21 

- 

DELETE 

22 

- 

FORMAT 

23 

- 

LOCK FILE 

2b 

- 

UNLOCK FILE 

25 

- 

POINT 

2 6 

- 

NOTE 

11 

— 

DRAW LINE 

12 

_ 

FILL 






Appendix C 


IOCB Status Bytes 



01 

— 

OPERATION COMPLETE (no errors) 


02 

- 

TRUNCATED RECORD 

ja$ 

80 

- 

BREAK KEY ABORT . 

136 

82 

- 

NON-EXISTENT DEVICE 

13^2 

84 

- 

INVALID COMMAND 

133 

85 

- 

DEVICE OR FILE NOT OPEN 

Irfr 

86 

- 

INVALID IOCB NUMBER (not stored in IOCB!) 

\% 

88 

- 

END-OF-FILE 

p3 

8A 

- 

DEVICE TIMEOUT (Device doesn't respond) 

137 

8B 

- 

DEVICE NAK 

)fO 

8C 

- 

SERIAL BUS INPUT FRAMING ERROR 

]4^- 

8E 

- 

SERIAL BUS DATA FRAME OVERRUN ERROR 

lt 3 

8F 

- 

SERIAL BUS DATA FRAME CHECKSUM ERROR 

in 

90 

- 

DEVICE DONE ERROR (Responds with invalid DONE byte) 

ni 

93 

- 

INSUFFICIENT MEMORY FOR SCREEN MODE OR BAD SCREEN MODE 

i 

AO 

- 

DRIVE # ERROR 

)U 

A1 

- 

TOO MANY OPEN FILES (NO SECTOR BUFFER AVAILABLE) 

]43 

A2 

- 

MEDIUM FULL (NO FREE SECTORS) 

JU 

A3 

- 

FATAL SYSTEM DATA I/O ERROR 

{04 

A4 

- 

FILE # MISMATCH 

IL$ 

A5 

- 

FILE NAME ERROR 

) L {? 

A6 

- 

POINT DATA LENGTH ERROR 

)U 

A7 

- 

FILE LOCKED 

1^ 

A8 

- 

COMMAND INVALID (SPECIAL OPERATION CODE) 

|U? 

A9 

- 

DIRECTORY FULL (64 FILES) 

HI 

AB 

— 

POINT INVALID 



Appendix D 


Device/filename Specification 


At OPEN time, the buffer pointer contains the address of 
the start of a device/filename specification. The 
specification consists of ASCII characters in the following 
format: 


<idevice specifier> 


<device number 



\/ filename *> 


EOL 


where: 


^device specifier^ letter device specifier—£>C =, Cassette 

M = Modem 

etc. 

^device number> = 1 - n (defaults to 1 if not specified) 

<Cfilename> = name of file 







Appendix G - SIO Status Codes 


Device Timeout (Device doesn't respond) 

Device NAK 

Serial Bus Input Framing Error 

Serial Bus Data Frame Overrun Error 
Serial Bus Data Frame Checksum Error 
Device DONE Error (Responds with invalid DONE byte) 



Appendix H 


Device Status Bytes 


DISK 


PRINTER 


Byte 1 


—invalid command frame 

-invalid data frame 

-unsuccessful write 

-write protect 

-active/standby? 


Byte 2 


T 


!—i i r 


Controller chip status 




i > 


Byte 3 


i i 


timeout 


Byte U 


n «"■ 


j— i 


Byte 1 


Byte 2 



—— 

t 

— i — i —|—i 

I 

— 

“I 

) 


! 

1 

-i . i.i l 

L 



i-' 


invalid command frame 


_invalid data frame 
intelligent printer controlle: 


AUX1 from previous command 


Byte 3 


i i 


J L 


timeout 


Byte k 

i * i 




















































































Appendix J- Serial Bias Device Address 


Floppy Disks 31-3^ 


16 


Printer 


W l6 

50 - 58 l6 



Modem 



Appendix K - Serial Bus Command. Codes/Control Codes 


Commands 

PUT 

50 

CP’) 

READ 

52 

CR) 

WRITE 

5T 

('W') 

STATUS 

53 

(’S’) 

FORMAT 

21 

Cl*) 


Control Codes 


ACK 

hi 

('A* ) 

NAK 

4E 

( *N*) 

COMPLETE 

U3 

('C* ) 

ERR 

U5 

CE') 





LT r ni O r O c 

CHPtfcAcrre£.S t 





























































